home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / filutil / alist100.zip / ANSILIST.DOC next >
Text File  |  1995-01-29  |  7KB  |  166 lines
  1. ────╥───╖            ╓───────╖
  2.     ║   ╙╖   ╓─────╖╓╜ ╓─────╫──╖ ╓──╖    ╓─╖╓─────╖╓───────╖
  3.     ║    ╙╖  ║     ╙╢  ╙──╖  ║  ║ ║  ║    ║ ║║ ╓───╜╙─╖ ╓───╜
  4.     ║  ╓╖ ╙╖ ║      ╙╖    ╙─╖║  ║ ╙╖ ║    ║ ║║ ║      ║ ║
  5.     ║  ║╙╖ ╙╖║  ╓─╖  ╙╥──╖  ║║  ║  ║ ║    ║ ║║ ╙───╖  ║ ║
  6.     ║  ╙─╜  ║║  ║ ╙╖  ║  ╙╖ ║║  ║  ║ ║    ║ ║╙╖    ║  ║ ║
  7.     ║  ╓─╖  ╙╢  ║  ║  ║ ╓─╜ ║║  ║  ║ ╙───╖║ ║ ╙──╖ ║  ║ ║
  8.     ║  ║ ╙╖  ╙╖ ║  ║  ╟─╜ ╓─╜║  ║  ║     ║║ ║╓───╜╓╜  ║ ║
  9.     ║  ║  ╙╖  ║ ║  ║  ╟───╜  ║  ║  ╙─────╜╙─╜╙────╜   ╙─╜
  10.     ╙──╜   ╙─╥╜ ║  ║  ║      ╙──╜
  11.              ╙──╜  ╙──╜
  12.  
  13.  ANSILIST v 1.00     29.1.95
  14. ═════════════════════════════  by Walter Gamba
  15.  
  16. ANSILIST is a small, but fast, text viewer. It has, as one can guess from the
  17. name, ANSI capabilities, i.e. it can display text with embedded ANSI escape
  18. sequences. It does not need ANSI.SYS, of course.
  19. ANSILIST is shareware, but cheap. Pleas read the Shareware notice.
  20.             ─────────
  21.  
  22.  file list
  23. ───────────────
  24. Your ZIP file must contain the following:
  25. ANSILIST.EXE    the exe file
  26. ANSILIST.DOC    this doc
  27. HUNGBOOK.COL    the test file
  28.  
  29.  
  30.  
  31.  
  32.  HOW TO RUN IT
  33. ───────────────
  34. To run ANSILIST simply type on the command line:
  35. >>ANSILIST filelame [/t] [/c]
  36.  
  37. "filename" is the name of the file you want to list. It can list files with up
  38. to 650,000 lines..
  39.         /t      will force ANSILIST to start in plain text mode (by default it
  40.                 starts in ANSI mode).
  41.         /c      will force it to start in ClearScreen mode (by default
  42.                 the ClearScreen mode is turned off).
  43.  
  44. ANSI mode: the ability to read end interprete ansi escape sequences.
  45.            when it is turned off ansi escapes are treated as normal text.
  46. ClearScreen mode: in this mode, before every screen update, the program will
  47.                   wipe off the screen. If this is turned off it won't.
  48. Read the ANSI section for details.
  49.  
  50. Typing ANSILIST alone will bring up a concise help.
  51.  
  52. ANSILIST Screen:
  53. ────────────────
  54. You will be presented with the first page of the document.
  55. At the bottom of the screen a Status Bar will contain (from right to left):
  56.  
  57.         -the name of the file you're viewing
  58.         -the Ansi status          (read the Ansi section)
  59.         -the Clearscreen status   (read the Ansi section)
  60.         -the number of the line displayed in the upper row of the screen
  61.         -the percentage of the text yo've already viewed (including the current
  62.                                                           page)
  63. Commands:
  64. ─────────
  65. While viewing a text you can use the following keys:
  66.  
  67. SPACE/ENTER/PGDWN       view next page
  68.              PGUP       view previous page
  69.  
  70.              HOME       moves to the beginning of the file
  71.               END       moves to the last page of the file
  72.  
  73.               DWN       view one line down
  74.                UP       view one liine up
  75.  
  76.              LEFT       view current page, one char to the left
  77.             RIGHT       view current page, one char on th right
  78.  
  79.                 A       toggle ANSI capability on/off
  80.                 C       toggle ClearScreen status
  81.  
  82.            Only Registered version:
  83.                 F       find a string in the file, from current position.
  84.                         matches ignoring case.
  85.                 N       find next occurrence of the string
  86.  
  87.                 L       load another file
  88.  
  89.  
  90.            In both versions:
  91.  
  92.               ESC       quit ANSILIST
  93.  
  94. When prompted with error messages hit a key to resume.
  95.  
  96. ANSILIST & ANSI files.
  97. ──────────────────────
  98. The texts this program was at first intended to work with were text files
  99. with ANSI esacape sequeneces which specified colour. This kind of text is
  100. very much similar to plain text, i.e. one line in the file corresponds to
  101. exactly one line on the screen. When I decided to implement all the other
  102. escape sequences, in order to be able to view ANSI drawings, I had some
  103. problems, mainly because an ansi file has not a one-to-one mapping between
  104. file lines and screen lines.
  105. When viewing large ansi file I suggest to use only the PGUP/PGDWN keys,
  106. since in an ansi file with embedded screen coordinates it is rarely effective
  107. to read the next file line hoping to see the drawing scrolling one line.
  108. This is because usually in ansi files it takes several lines in the file to
  109. specify one line on the screen.
  110. Moreover, since ansi drawing is not sequencial, but can move the cursor
  111. everywhere, sometimes portions of the screen are left untouched (and
  112. supposed black). Since we are using a text viewer, the screen is always
  113. covered with characters and rarely empty. That's why I included the option
  114. of clearing the screen before any screen update( i.e. before any movement
  115. command). One can toggle this function on and off with the C key.
  116. This function is useless when viewing files in plain text mode.
  117.  
  118. Why an ANSI file viewer?
  119. ────────────────────────
  120. I was bored to use "type moo.ans" to view files with ansi escapes. When I
  121. discovered GnuAWK and used it to colour up some text, I needed one to check
  122. my work easily, scrolling up and down etc..
  123. I include a Monty Python's sketch -The Hungarian Phrasebook-, coloured so as
  124. to be more readable,as a test of the capabilities of this tiny software.
  125. Should you be interested, I have some little GAWK script able to turn a
  126. screenplay in a coloured screenplayin many ways. Just E-Mail me.
  127.  
  128.           BUGS REPORT
  129.  ──────────────────────────────
  130. Since this is my first release, it is possible that my program has some bugs.
  131. Even if you are not registered, it would be very useful to report any bug
  132. to me (possibly via E-Mail). Thanx.
  133.  
  134.         SHAREWARE NOTICE
  135.  ──────────────────────────────
  136. This program is not free, since it has costed me some (light) work finding
  137. out how the hell Ansi really works...
  138. If you keep on using it after a trial period of 23 days tou should register.
  139. To register just send me a Self Adressed Stamped (enuff stamps to allow shippage
  140. of a floppy diisk...) envelope with 5$ (French Francs and Italian Lire of the
  141. roughly same value are OK).
  142. It is a small fee, but it will help me improve ANSILIST and my many other.
  143. projects. Remember to specify if your computer can read 720K disks (which
  144. are cheaper :) ). I will ship you the disk with the registered version which
  145. include some facilities not implemented in the shareware version.
  146.  
  147.        REDISTRIBUTION
  148.  ─────────────────────────
  149. You may freely redistribute this software as long as you don't alter it and you
  150. keep the ZIP package unaltered. All disclaimers and legal stuff as usual...
  151.  
  152. My address is:
  153.         Walter Gamba
  154.         via Torricelli 36
  155.         10129 Torino
  156.         ITALY
  157.  
  158.         E-Mail: IPER1@pol90a.polito.it
  159.  
  160.         ╒═╕╒═╕╒═══╕╒═╤═╕   ╒════╤═══╕╒═╕╒═══╕  ╒═╕
  161.         │ ╘╛ ╞╛╒═╕╘╡ │ │   │ ╒══╡ ╒╕╘╡ ││ ═╤╛  │ │
  162.         │    │ ╘═╛ │ │ ╘═╕ │ ╘═╕│ ╘╛╒╡ │╘═╕╘╕  │ │
  163.         │ ╒╕ │ ╒═╕ │ │   │ │  ═╧╡ ╒╕╘╡ ╞══╛╒╛  ╞═╡
  164.         ╘═╛╘═╧═╛ ╘═╧═╧═══╛ ╘════╧═╛│ ╞═╧═══╛   ╘═╛
  165.                                    ╘═╛
  166.